home *** CD-ROM | disk | FTP | other *** search
/ Power Tools for Macintosh / Power Tools for Macintosh (SoftBit)(1992).iso / Da's / A-B / Afterthought 1.4 / Afterthought Text Guide < prev   
Text File  |  1987-11-13  |  11KB  |  232 lines
  1. A.  Welcome to Afterthought
  2. --------------------
  3.  
  4. A(1).  What is Afterthought?
  5. --------------------
  6. The Afterthought Editor is a desk accessory programming editor, modeled 
  7. after MDS Edit.  It is disk-based, and can read documents of up to 8,000,000 
  8. bytes.  Its features include true tabs, full undo, auto-indent, 
  9. case-insensitive Find, and jump to line number.  It can open two documents 
  10. at the same time, and it prints documents as well.
  11.  
  12. A(2).  How to Get Afterthought
  13. --------------------
  14. Afterthought is distributed exclusively by Jimmy Mac Software.  Order it by 
  15. sending $20.00 to:
  16.  
  17.                Jimmy Mac Software
  18.                P.O. Box 957
  19.                Murfreesboro, Tennessee   37133
  20.  
  21. You will get back a disk with the fully-functional version of Afterthought, a 
  22. utility to help you run Afterthought with memory hogs like TML Pascal, and 
  23. a printed Users' Guide.
  24.  
  25. Updates are free; you can always get a copy of the current version of
  26. Afterthought if you will send your original Afterthought disk, plus $1.00
  27. for packaging and postage.
  28.  
  29. A(3).  Technical Support
  30. --------------------
  31. Jimmy Mac Software will be happy to help you with any problems you might 
  32. encounter while using Afterthought.  You can write Jimmy Mac at:
  33.  
  34.                Jimmy Mac Software
  35.                P.O. Box 957
  36.                Murfreesboro, Tennessee   37133
  37.  
  38. or send Genie electronic mail to CLIFF.
  39.  
  40. B.  Using Afterthought
  41. --------------------
  42. Afterthought is modelled after MDS Edit, so if you are familiar with that 
  43. program, you shouldn't have any trouble using Afterthought.  When you 
  44. choose Afterthought from the desk accessory menu (the Apple menu), a new 
  45. window, entitled “Afterthought : untitled” appears.  This is the 
  46. Afterthought editing window; its title will always be “Afterthought : ” 
  47. followed by the name of the document.  Afterthought also adds a new menu, 
  48. titled “AEdit”, to the menu bar, and it uses the Edit menu that should 
  49. already be there (if there's no Edit menu in your application, don't worry; the 
  50. standard keyboard equivalents will still work).  Initially, the window 
  51. contains copyright and other information; you can clear this with the New 
  52. command.
  53.  
  54. B(1).  Opening Files
  55. --------------------
  56. You can open documents with the usual New and Open commands.  There are 
  57. two subtleties, though.  First, you never close a document; an open document 
  58. is closed automatically when you open a new one on top of it.  If you have 
  59. made any changes to the document, you will be asked if you want to save it 
  60. first.  DO NOT CLICK THE CLOSE BOX!  Clicking the close box means Quit, not 
  61. Close.  Second, there are actually TWO documents open at all times:  a 
  62. “foreground” document visible in the window, and an invisible “background” 
  63. document.  You can switch between them with the Window command.
  64.  
  65. B(2).  Editing
  66. --------------------
  67. Afterthought is designed to work as a programming editor; it does not 
  68. word-wrap, and it automatically indents each new line the same number of 
  69. tabs and spaces the line above was indented.  It supports true tabs; that is, 
  70. it places tab stops at intervals across the window and skips to the next tab 
  71. stop when you type a tab.  (You can set the tab spacing with the Format 
  72. command.)  It supports all the standard Edit commands, including Undo, even 
  73. if the host application does not have an Edit menu (that is, the keyboard 
  74. equivalents Z, X, C and V for Undo, Cut, Copy and Paste work even without an 
  75. Edit menu).  The arrow keys will move the insertion point (so long as there 
  76. is a blinking insertion point, instead of a text selection), and the Enter key 
  77. will scroll the insertion point into the window without changing the text.
  78.  
  79. B(3).  Printing
  80. --------------------
  81. Afterthought has two print commands:  the standard Print... and Quick Print.  
  82. Print does a what-you-see-is-what-you-get, formatted print.  Quick Print 
  83. skips the formatting and writes directly to the printer.  Quick Print is 
  84. faster (as the name suggests) than Print... but Print... produces better 
  85. looking documents.  It uses Macintosh fonts (Quick Print uses the printer's 
  86. font) and handles tabs correctly (Quick Print treats tabs characters as 
  87. spaces).
  88.  
  89. B(4).  Quitting
  90. --------------------
  91. Afterthought does not have a Quit command.  The only way to quit 
  92. Afterthought is by clicking the close box of the Afterthought window.  If 
  93. you do that, it's final; there's no way to cancel a quit.  (There's actually a 
  94. second way to quit:  quit the host application.  Afterthought will go through 
  95. a normal quit, asking if you want to save changes and so on.)
  96.  
  97. B(5).  Disk and Memory Errors
  98. --------------------
  99. Afterthought is disk-based, and it may run out of disk space.  On the other 
  100. hand, it must keep some information in memory, and it may run out of RAM.  
  101. It operates with a 100-line, 8000-character margin of safety.  If it runs out 
  102. of disk or memory, it can finish whatever it is doing at the moment before 
  103. it must shut down.  For example, if you paste 30 lines but there is only 
  104. enough disk space for 15, it will paste all 30 because the 100-line margin 
  105. means there is actually space for 115.  Having successfully completed the 
  106. Paste command, Afterthought will post an error message, and then go 
  107. through a normal Quit sequence, asking if you want to save changes.  The 
  108. only time you need to worry about your data is if you did something that 
  109. involved more than 100 lines (or more than 8000 characters).  There's a 
  110. subtlety here:  you must consider not just what you are putting in, but what 
  111. you are taking out as well.  If you delete or type over or replace text, the 
  112. deleted text is copied to a special undo record BEFORE it is removed from 
  113. the edit record.  Thus, you should neither add nor delete more than 100 lines 
  114. at one time.
  115.  
  116. C.  The AEdit Menu
  117. --------------------
  118.  
  119. C(1).  About Afterthought...
  120. --------------------
  121. The About Afterthought command closes the current foreground document 
  122. and replaces it with information about Afterthought.  If you have made any 
  123. changes to the original document, you will be asked if you want to save 
  124. them, and you can cancel the command at that time.
  125.  
  126. C(2).  New
  127. --------------------
  128. The New command closes the current foreground document and replaces it 
  129. with an empty, untitled document.  If you have made any changes to the 
  130. original document, you will be asked if you want to save them, and you can 
  131. cancel the command at that time.
  132.  
  133. C(3).  Open...
  134. --------------------
  135. The Open command closes the current foreground document and replaces it 
  136. with a previously-saved document.  If you have made any changes to the 
  137. original document, you will be asked if you want to save them, and you can 
  138. cancel the command at that time.  You can also cancel the Open command at 
  139. the open-document dialog; the original document will remain open.
  140.  
  141. C(4).  Window
  142. --------------------
  143. Afterthought always has two documents open (either or both of which may 
  144. be blank).  It displays only one at a time; this is the FOREGROUND document.  
  145. The undisplayed document is called the BACKGROUND document.  The Window 
  146. command switches the foreground document (visible in the window) with 
  147. the background document (invisible).  This is the only command that affects 
  148. the background document; all others (New, Open, ect) affect the foreground.
  149.  
  150. C(5).  Insert...
  151. --------------------
  152. The Insert command inserts a previously-saved document into the foregound 
  153. document at the insertion point (or in place of the text selection).  You can 
  154. cancel this command at the open-document dialog.
  155.  
  156. C(6).  Save
  157. --------------------
  158. The Save command saves the current foreground document to disk.  If the 
  159. document has not previously been saved,  you will be prompted for a name to 
  160. save it under, and you can cancel the command at this point.  THIS COMMAND
  161. IS DISABLED IN THE DEMO VERSION.
  162.  
  163. C(7).  Save As...
  164. --------------------
  165. The Save As command will save the current foreground document under a 
  166. new name or in a different folder (or both).  You will be prompted for the 
  167. new name or folder; you can cancel the command at this point.  THIS
  168. COMMAND IS DISABLED IN THE DEMO VERSION.
  169.  
  170. C(8).  Format...
  171. --------------------
  172. The Format command will display a Format dialog, from which you can 
  173. select the font, font size, tab width and creator signature for the current 
  174. foreground document.  The tab width is measured as a multiple of the width 
  175. of a space character.  The Make Default button will save your selections and 
  176. use them the next time you open a New document, or open an existing 
  177. document that does not have the MDS Edit format resources.
  178.  
  179. C(9).  Show Invisibles
  180. --------------------
  181. The Show Invisibles / Hide Invisibles command toggles the current 
  182. foreground document between the standard editing mode, and one in which 
  183. invisible characters (such as spaces, tabs and illegals) are replaced by 
  184. special visible characters.  Spaces are replaced by a little diamond, tabs by 
  185. a triangle, and illegals by an upside-down question mark.  (The Show 
  186. Invisibles command does not display carriage returns.)
  187.  
  188. C(10).  Select All
  189. --------------------
  190. The Select All command selects the entire foreground document.
  191.  
  192. C(11).  Find...
  193. --------------------
  194. The Find command displays a dialog in which you may type a string to search 
  195. for.  Case is ignored.  If there is some text already selected when the Find 
  196. command is issued, this text is automatically copied into the dialog and 
  197. selected.  The menu commands work even with the Find dialog active; in 
  198. particular, you can switch between background and foreground, or paste.
  199.  
  200. C(12).  Go to...
  201. --------------------
  202. The Go To command displays a dialog which tells you how many lines there 
  203. are in the current foreground document, and the number of the line in which 
  204. the current selection begins.  You can type in the number of another line, and 
  205. Afterthought will jump to it.  The menu commands work even with the Go To 
  206. dialog active; in particular, you can switch between background and 
  207. foreground, or paste.
  208.  
  209. C(13).  Page Setup
  210. --------------------
  211. The Page Setup command puts up the usual setup dialog.  The Print command 
  212. will also go through this dialog if you have changed printers; Page Setup is 
  213. provided as a separate menu command in case you want to change any of the 
  214. settings.  THIS COMMAND IS DISABLED IN THE DEMO VERSION.
  215.  
  216. C(14).  Print...
  217. --------------------
  218. The Print command displays the Page Setup dialog (if you have changed 
  219. printers without calling the Page Setup command), then the Print dialog, and 
  220. finally prints the current foreground document.  The printed text is 
  221. identical to that displayed on the screen, except that it does not display 
  222. invisible characters.  You can cancel the command at either dialog.  THIS
  223. COMMAND IS DISABLED IN THE DEMO VERSION.
  224.  
  225. C(15).  Quick Print
  226. --------------------
  227. The Quick Print command immediately prints the whole foreground 
  228. document directly to the printer, without any dialogs and without any 
  229. formatting.  It uses the printer's character set, and transliterates tabs into 
  230. spaces.  It is faster, and uglier, than the standard Print.  THIS COMMAND
  231. IS DISABLED IN THE DEMO VERSION.
  232.